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1. INTRODUCTION 

UT is a user (as opposed to server) telnet program designed to ran under 
the ITS tiro sharing systen. It implements the relatively recent ARPA network 
negotiating protocol for telnet connections. 

The basic philosophy of UT is to have a nuaber of 'ports', as explained 
in section 2, each of which represents a conplex external interface to a user's 
console, a network connection, or a file. The relatively sinple Internal 
interfaces of the "ports 1 can be interconnected in various ways. 

A variety of comands can be detected by UT at each port as explained in 
section 3. 

Using the basic facilities of UT is not as conpllcated as it nay se«m. 
If you just keep in mind that comands are preceded by a <CNTRL-UP-ARROV> and 
read the descriptions of the first few comands starting at subsection 3.1 t it 
should be possible to carry on network conversations. 

2. PORTS 

All of UT's input and output is done through ports each of which is a 
logical bidirectional channel. Each port has both an Input and an output side of 
which only one is used in some cases. In the simplest case of network use 
through UT. the user's console is on one port and a network connection to another 
computer system in on a second port. These are ports with both Input and output 
open in the obvious way. They would be interconnected through UT so that the 
input on each port is directed to the output side of the other. Depending on how 
various echoing switches are set, the input of either, both, or neither of these 
two ports could also be connected to its own output side. 

The naxlmun nuntoer of ports that can exist at one tiae in UT is seven. 
Each port has a unique name up to six characters long which is the only way the 
usor can generally refer to ports in comands to UT. The primordial port on 
which the user's console is open has the nane "TH*. In comands, the port by 
which the cotvsand is being executed can be referred to by the special name 
■self". 

Anong the flags kept for a port are the following: 

a) If case shifting Is in effect. 

b) If the last character in was an effective <CWTRL-q>, 

c) If protocol messages should be typed out when the port has a teletype 
open for output on it. 

d) The desired and actual believed local and rewte states of echoing and 
go-ahead suppression. 

e) If output on that port is clogged. 

f) If input on that port is blocked because it would result in output to 
a clogged port. 

g) The relative count of data aerks and oct of band interrupts received 
on the port. 

There are actually two types of connections between ports, *ln- 



connection* 1 and "output-monitoring". If port A Is in-connected to port B. input 
on port A Is output on port B. If port A Is output-monitored to port B, then all 
output on port A, except that from an output-monitor connection. Is also output 
on port B. Thus the spread of an ordinary character input to a port is as 
follows; la) It My be echoed back out by UT; lb) If echoed, it -ill also be 
output on all ports out put -monitoring the original port; 2a) It Is output on all 
ports in-connected from the original port, if any; 2b) for each In-connected 
port, it will also be output on all ports output -monitoring the in-connected 
port. 

3. COMMANDS 

Conniands can be detected on input to any port (even several commands on 
several ports "simultaneously") if that port is "sensitive* to the particular 
coneiand type. There are five types of cowwnds as follows: 1) new telnet 
protocol messages (beginning with <IAC>), 2) old telnet protocol characters, 3) 
VT comands beginning with <CMTRL-UP-ARROW> l 4) <CNTRl-Q>. and 5) \ (backslash). 
The initial user console port is sensitive to all types of coonands. The initial 
sensitivity of other ports is as described with the cotnend that creates the 
port* (See also the sensitize and desensitize connands.) 

Taking the above types of cotnands in reverse order, \ simply changes the 
UT case shift state for that port for the next character only (see also the shift 
and unshift comoands)* <CNTRl-Q> desensitizes the port for the following 
character only so that it will not be recognized if it would nonially be a 
command. <CN7RL-UP-ARR0W> Indicates the beginning of a UT coraand; If the 
immediately following character Is one listed in section 3.0 then the two 
characters together constitute the entirety of the comand* otherwise a 
multicharacter connand will be read as described in the next paragraph. Old 
telnet protocol characters, which oostly affect echo, basicly take effect by 
being passed through on input and noticed on output to a port with a teletype on 
it. New telnet protocol cotnands are parsed and. if understood (UT currently 
knows only about the echo and suppress-go-ahead options), agreed to. UT 
initially tries to negotiate remote echo and go-aheads suppressed both ways. Go- 
aheads received by UT have no effect- UT will transmit go-aheads by an idleness 
time-out mechanism to other systems that insist on it. Understood telnet 
protocol negotiation messages are acted on at the receiving port and not passed 
through although most other new telnet protocol signals are passed through. The 
desired propagation of echo changes occurs by the following mechanism. Whenever 
an echo negotiation message is received that requests a change, it is agreed to 
and a message of opposite polarity and sense (DO goes to WWT, DVT goes to WIL, 
etc) is simulated as having been received on every port in-connected from the 
port on which the original request was received. 

"Multicharacter* commands to UT are read, for each port, into a buffer 
until terminated by a carriage return or lint feed. Characters can be rubbed out 
and <RUBOUT>, <CARRIAGE-RETURN>, etc. can be put in by proceeding them with 
<CNTRL-Q>. After the coanand is terminated, it Is then parsed, usually entirely 
into syllables, but at least into an Initial coomand word syllable and the 
remainder of the conmand. Syllables are terminated by •:", ";", "<", ">", or any 
character whose ASCII code is 40 or less. Syllables ending with ":" and *(■ are 
usually recognized as devices and system names, those ending with ">" or "<" are 



normally recognized as ports, and all other syllable* art called plain and may be 
files names, host names* ate. Any of the termination characters can be included 
in a syllable by proceeding it with <CNTRL-Q>. (<CNTRL-Q> always works in this 
context of a cownand regardless of the port's sensitivity to it.) The first 
syllable, regardless of Its type, Is looked up as a connand in the table nostly 
listed by the help command. If it it found it then controls the parsing of the 
rest of the command. In general, the position of the device, system name, and 
port type syllables is not significant. Later ones override ones to their left 
and they are skipped when plain syllables ^re being looked for. 

In most cases, syllables are looked up in tables in such a way that the 
unambiguous start of a table entry will be recognized and its completion typed 
out. The multicharacter conoands in the headings' of the parts of this section 
show by their initial capital letters how ouch is necessary to specify the 
connand. In some cases, an attenpt is made to parse a syllable, especially if 
otherwise unrecognized, as an octal number. 

3.0 'Single Character** Commands 

The following characters have the effects given when following a <CNTRL-UP -ARROW > 
on a sensitive port: 

A Equivalent to typing an Are-You-There new protocol message. 

8 Equivalent to typing a Synch new protocol messege (break). 

C Equivalent to typing an Interrupt-Process new protocol message. 

G Equivalent to typing a Go-Ahead new protocol message. 

H Equivalent to typing an Erase-Character new protocol message. 

M Directly turns off local echo (No echo). 

S Equivalent to typing an Erase-Output new protocol message* 

X Equivalent to typing an Erase-Line new protocol message. 

V Directly turns on local echo (Yes echo). 

<CNTRL -UP -ARROW) Equivalent to typing this character on an unsensltive port. 

? Prints a list of "single character* con&ands and also includes in the list 

the help conmand to tell you how to get a list of multicharacter commands. 
\ Pemanently complements UT's case shift state (as opposed to \ by itself 

which just complements It for the next character). 
<UP-ARR0W> 
<BACK-ARROU> These two characters put UT input on the port into e mode where 

it reads successive sets of three octal digits as characters (values up to 

377 are allowed for protocol characters). The only difference between them 

is that <UP-ARR0W> puts an <IAC> in front of everything. 

3.1 HElp 

LISTCommands 

These conroands print out a list of most of the multi-letter cotmands 
available in UT. Each coomand listed is followed by its dispatch address in 
UT, then an asterisk in some cases, and finally a brief content. If an 
ambiguous partial comnand is entered but only one of the possible 
completions has an asterisk after it. that one will be chosen. 



The first conroand listed is *?" even though this is not a multi-letter 
comaand. It is there to remind the usar that ha can gat a list of single 
character coonands by typing a <C*ITRL-UP-AMOW>TV 

3.2 Connect [port] [host [sooket]] 

This cotnand is the basic cotnand for flaking connection over the network.. 
If no port is specified, a port nam will be genspNd by UT. If no host 
nam or nunber is given, the last hast designation used will be used again 
(this is Initially NL for nathlab). If a host nana or nunber is present, * 
socket nunber may also be specified irtich will be used, for that connect 
only, instead of the default socket nunber 1. 

If all goes well, a network connection will be oade on the port to the host 
[socket] specified- The network port will ba initially sensitized only to 
old and new telnet protocol coanands. This port and the port through which 
the connect covnand was entered (usually TTY) are then in-connected to each 
other. 

In case of a serious error or a tine out in trying to establish a network 
connection, the port is obliterated as if by a disconnect cotmand. The tine 
allowed for response by the logger of the systen being connected to is the 
larger of 12, seconds and the UT's patience setting (see the patience 

COMftAd). 



3.3 HOsts 

LISTHosts 

These coanands list the host nuaes recognized by the connect coonand. Each 
host nar is followed by its network host nunber. 

3.4 Disconnect [port] 

This is the only coanand available to close out the flle(s) or connectlon(s) 
open on a port and free up the port slot. In the process, all ln-connectlon 
and output-monitor links fron or to the port are severed and the port nave 
is obliterated. 

If more than one port is entered after the disconnect coaaiand, only the last 
one will be disconnected. If no ports are listed after the command, all 
ports in-connected from the port on which the coanand is entered will be 
disconnected (ports just output-monitoring the coasand port are unaffected)* 

3.5 Listports 

POrts 

These conaands list all active port slots and give the following Information 
for each: 

Port nana; 



Input type, tf blocked, and file name; 
List of ports In-connected to; 
Output type. If blocked, and file name; 
List of ports output-nonitored to. 

An input or output blocked state Is inldicated by printing ■<>•, 

(For debugging purposes the effect of these coanands can bt produced fro* a 
HACTRN with a UT as its currently selected inferior by typing "PUSHJ 
P.LPJXV) 

3.6 MONitor [[port2] portl] [file] 

All the characters being output on a particular port (except those cooing 
froo an output-monitor link) can be monitored by being output through 
another port to a specified file with this command. First a file is opened 
for output on a port determined as described below. If any part of the file 
description is not specified, it defaults to that last used with a nonitor 
connand from any port and is initally DSK: UT.OUT >. An output-nonitor link 
is then made to the port on which the file has been opened froo a port 
determined as described below. 

If no port is specified with the command, the port on which the cotnsand is 
entered is output -monitored to a port with a gensyued nane on which the file 
was opened* If exactly one port is specified, that port 1$ output-nonitored 
to a port with a gensyned name on which the file was opened. If two or more 
ports are specified the last is output -monitored to the file opened on the 
next to the last named port. 

Since It is thought that it will be frequently desired to monitor telnet 
conversations spanning connection and disconnection with several remote 
hosts and to monitor parts of conversations with single remote hosts, the 
disconnect comand defaults in such a way as to not automatically close 
ports output-nonitored from the port on which the disconnect is entered. 

3_7XHIe [port] [file] 

This coonand opens a file for input on a port sensitive to ell types of 
connands except old and new telnet protocol coanands. If no port Is 
specified, a port name is gensymed. If any part of the file description Is 
not specified, it defaults to that last used with an xflle connand fro* any 
port and Is initially set by the inlt file feature (see section 4.1). 

3,8 As-if-from port command 

This connand enables nultlcharacter UT contends to be entered on one port 
but executed as though input on another port* It is unique in that the 
Tirst port nane after the connand word Is controlling and their must be a 
port specified. All of the characters after the •>• or ■<■ terninating the 
port name are transfered to the comand buffer or port specified unless the 



buTfer Is already in use In which cast 'BUSY 1 is typed out. You should not 
put an additional <CNTl-UP-ARROU> in the as-if-from'ed comand. 

3.9 XBreak \ IMake \ OBreak \ OMake portl porta 

These contends respectively break and oake in-connection links and break and 
make output-aonitoring links. In each case a unidirectional link from portl 
to portZ is affected. At least two ports oust be specified and if more than 
two are specified, the rightmost two are used. 

3.10 DEsensltize \ SEnsitize characters 

These cooraands allow the sensitivity of a port to various connand types to 
be set. All the characters after the character terminating the conoand word 
are scanned and the port for which the connand is being executed is 
appropriately sensitized or desensitized if a \, <CNTRL-Q>, <CNm-UP- 
ARROW>, N (for new telnet protocol), or (for old telnet protocol) Is 
found. To affect a port other than the comand entry port, use the as-if- 
from contend* 



3.11 I Ac [port] protocol-words 

This connand allows arbitrary new telnet protocol messages to be sent out 
froo a specified port, or. if none Is specified, from every port in- 
connected from the command entry port. Octal nunbers for protocol 
characters as well as the following symbols can follow the iac comand: AO, 
AVT, BRK, WIT, HI, DO, EC, ECHO, EL, GA, IAC. IP, NOP, SB, SE, SGA, MIL, and 
VNT. The character sequence represented by the arguments to the iac comand 
is then transmitted with an <IAC> in front of it. 

3.12 IGnore \ UNIgnorc characters 

UT has a one bit flag for each character with a network code of less than 
200. Inltally these flags are off for all characters except the null 
character, code 0- Characters for which the flag is on are ignored on input 
unless they occur in a coronand. This ignore flag can be turned on or off 
for various characters with these comands. The characters affected are all 
those from just after the break character terminating the comand word to 
the end of the comaand line. (Carriage return, line feed and <CNTRL-Q> can 
be included by preceeding then with <CinM,-»Q>*) 

3.13 Interrupt [port] 

This connand causes a telnet interrupt to be output on a single port, if one 
is specified. Otherwise, an interrupt is sent on all ports that are in- 
connected from the port on which the interrupt comand was entered. The 
interrupt signal referred to here is an out of band signal and a matching 
data mark in the data stream. They should cause most of the data sent over 



the telnet connection before the data nark: to be skipped by the receiver. 

3.14 MORo \ NOmore 

The "flORE"* feature of the ITS system is turned on or off for a port by 
entering these conmands through the port. The "H0RE" feature is Initially 
off and when on it causes output to a display terminal to stop at the bottom 
of the screen until the user types a space. 

3. 15 NEw \ OLcI 

UT is somewhat conpatible with both the new and old telnet protocols. It 
reponds properly to the receipt of either type of protocol message. The 
switch set by these coooands sets the protocol used lti transmitting some 
messages over telnet connections* 

3.16 OPmque \ Transparent 

The characters <CNTRL-Z> and <OmtL-LEFT-MR0U> are normally interpreted by 
the ITS systen and not let though to user programs. This Is the opaque 
state- In the transparent state, these two special characters are 
transmitted through to user programs by ITS*. These commands set user 
console connections on port on which they are entered to the state they 



3.17 PAtience [number) 

UT attempts to detect certain hung up states by timing then to see if they 
exceed a patience threshold. This is initially S seconds and can be set by 
a patience conmand followed by the octal number of second desired. Whether 
or not the patience coomand is followed by an argument, It types out the 
resulting patience setting as a decimal number of seconds. 

3.18 PRInt arg 

This coneiand with no argument prints out 'OFF', "0N\ or "FANCY" as the 
protocol message flag for the port the comand is entered on is set to 
Inhibit print outs, print out in octal, or print out mnewonically. The 
connand may be followed by any of the three print out words or 0. 1« or -1, 
respectively, to set the print out flag for the port. 



3.19 PROcmed \ Quit 

These comands respectively valret a ":PRCED" and a ":IL1LL* to HACTftH. 



3.20 SHift \ DNShift characters 

These comnands are similar to the Ignore and unignore comands In that they 
set or clear a bit globally associated with each possible character coda In 
UT. If the shiftable bit Is on for a character It has 40 xored with It If 
UT Is In the shlftad state (see •<CWTRL-UP-ARROW>\- in section 3.0). 
Initially only the upper and lower case letters art shif table* 

3.21 TBst [args] 

This connand Is for testing the parsing routines In UT and Jost prints Its 
arguments back as parsed. 

4. FEATURES 

4.1 Inlt File 

When UT is first starttd. It Is as though the user had Just typed 
■<CNTRL-UP-ARROU>XFILE .UT .INIT.*. This will automaticly execute a file of that 
name if one exists In the user's directory. If not, "HO INIT FILE' is typad out 
as Is always the case when & fllft ii hot found whose second natte is .INIT.. The 
user nay find it particularly convenient to set switches for the TTY port with 
A5-IF-FROP1 TTY> . . . contends In the Inlt file. To see what is going on, you 
can put a "<CNT8L-UP-ARR0W>OHAKE SELF) TTY>- at the start of tht flit to output- 
monitor the xfile port to your console. 

4.2 Direct Protocol Negotiations 

In som sense, the user has complete freedom to conduct protocol 
negotiations. You can make a telnet connection, turn on protocol printing for 
your console's port (see print coonand), and desensltlza tha network port to 
<IAO. Then you can use the lac comand to send direct protocol Des sages and the 
replies will Just ba passed through UT and typed out on your console- 



